<?php
/**
 * Implements this interface and define the function that operate with the
 * Twitter social network.
 * 
 * The social-functions (like tweet()) operate directly with the social network
 * and public the information about the extended Object as the function are implemented. 
 * 
 * @author Matteo Vigoni <mattevigo@gmail.com>
 *
 */
interface TwitterInterface
{
	/**
	 * Get the email address of the connected Twitter account
	 * 
	 * @return string an email address
	 */
	public function getTwitterEmail();
	
	/**
	 * Get the username of the connected Twitter account
	 * 
	 * @return string the account username
	 */
	public function getTwitterUsername();
	
	/**
	 * Get the password of the connected Twitter account
	 * 
	 * @return string the account password
	 */
	public function getTwitterPassword();
	
	// SOCIAL FUNCTIONS //////////////////////////////////////////////////////////////////
	
	/**
	 * Public a tweet on Twitter
	 * 
	 * @param User the User object
	 * @return true if success
	 * 			false otherwise
	 */
	public function tweet( User $usr );
}